Skip to content

feat(docs): ensnode.io -- refinements to LP & docs#2158

Merged
lightwalker-eth merged 7 commits into
mainfrom
y3drk/feat/ensnodeio-new-lp-background
May 20, 2026
Merged

feat(docs): ensnode.io -- refinements to LP & docs#2158
lightwalker-eth merged 7 commits into
mainfrom
y3drk/feat/ensnodeio-new-lp-background

Conversation

@Y3drk
Copy link
Copy Markdown
Member

@Y3drk Y3drk commented May 20, 2026

Lite PR → ensnode.io -- refinements to LP & docs

Summary


Why


Testing

  • Ran typecheck, lint, and test commands locally to ensure that the migration didn't break anything, and later confirmed that in our CI workflow
  • Verified that the UI didn't break after introducing changes using a local and Vercel (build) previews

Notes for Reviewer (Optional)

  • Pure UI/UX changes, so I don't think that the changeset log is required

Pre-Review Checklist (Blocking)

  • This PR does not introduce significant changes and is low-risk to review quickly.
  • Relevant changesets are included (or are not required)

@Y3drk Y3drk self-assigned this May 20, 2026
@Y3drk Y3drk added the docs Docs related label May 20, 2026
Copilot AI review requested due to automatic review settings May 20, 2026 08:54
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented May 20, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
enskit-react-example.ensnode.io Ready Ready Preview, Comment May 20, 2026 1:36pm
ensnode.io Ready Ready Preview, Comment May 20, 2026 1:36pm
2 Skipped Deployments
Project Deployment Actions Updated (UTC)
admin.ensnode.io Skipped Skipped May 20, 2026 1:36pm
ensrainbow.io Skipped Skipped May 20, 2026 1:36pm

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented May 20, 2026

⚠️ No Changeset found

Latest commit: ab22ade

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 20, 2026

Review Change Stack

Warning

Rate limit exceeded

@Y3drk has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 21 minutes and 7 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 16006c90-25ac-4e5f-8ea4-61c6f9076dc2

📥 Commits

Reviewing files that changed from the base of the PR and between 484267d and ab22ade.

📒 Files selected for processing (9)
  • docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx
  • docs/ensnode.io/src/components/organisms/OmnigraphAPIExample.astro
  • docs/ensnode.io/src/components/overrides/Hero.astro
  • docs/ensnode.io/src/content/docs/docs/integrate/index.mdx
  • docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enskit/example.mdx
  • docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enskit/index.mdx
  • docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enssdk/example.mdx
  • docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enssdk/index.mdx
  • docs/ensnode.io/src/styles/onScrollHeader.css
📝 Walkthrough

Walkthrough

This pull request updates the ENS documentation website with scroll-aware header behavior, consistent emoji repositioning across integration guides, a hero section redesign with new assets, and minor UI refinements including icon additions and sidebar styling adjustments.

Changes

Documentation Site Visual and Content Updates

Layer / File(s) Summary
Scroll-responsive header behavior
docs/ensnode.io/src/components/molecules/HeaderButtons.tsx, docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx, docs/ensnode.io/src/scripts/ScrollHeader.js, docs/ensnode.io/src/styles/onScrollHeader.css
HeaderButtons and HeaderMobileNavigation components now conditionally apply onScrollContainer styling based on isScrollable prop. ScrollHeader.js extends scroll observer to toggle scrolled class on mobile navigation elements. New CSS rules in onScrollHeader.css define distinct hover colors for scrolled vs. non-scrolled states.
Documentation content emoji reordering
docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts, docs/ensnode.io/src/content/docs/docs/integrate/index.mdx, docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enskit/example.mdx, docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enskit/index.mdx, docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enssdk/example.mdx, docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enssdk/index.mdx
Lightning emoji ⚡ repositioned from leading to trailing position consistently across sidebar labels, LinkCard titles, and MDX page titles for both enskit and enssdk interactive examples.
Hero section visual redesign
docs/ensnode.io/src/components/overrides/Hero.astro, docs/ensnode.io/src/layouts/Layout.astro, docs/ensnode.io/src/pages/index.astro
Hero component switched to new hero and background assets with black background container. Responsive padding and typography updated. "Quickstart guide" link now uses legacyButtonVariants. Mobile and desktop badge images added with different sizing. Home page section layout simplified with explicit padding utilities.
UI refinements and styling
docs/ensnode.io/src/components/organisms/OmnigraphAPIExample.astro, docs/ensnode.io/src/styles/starlight.css
OmnigraphAPIExample imports and renders left-arrow icon in back navigation. Sidebar styling updated to set font-weight: normal for non-top-level items.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

  • namehash/ensnode#2085: Updates Hero.astro "Quickstart guide" CTA markup and styling alongside the main PR's Hero component redesign.
  • namehash/ensnode#2121: Edits the integration quickstart LinkCard copy in docs/ensnode.io/src/content/docs/docs/integrate/index.mdx, overlapping with emoji reordering changes.
  • namehash/ensnode#2151: Modifies HeaderButtons component and mobile navigation behavior at the same code surface as the scroll-responsive header changes.

Poem

A dash of emoji, left-to-right,
Headers that scroll with grace so light,
A hero reborn with fresh new shine,
The docs now dance in perfect design! ⚡

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately reflects the main changes in the PR: refinements to the ENSNode landing page and documentation with updates to typography, styling, components, and assets.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description check ✅ Passed The PR description follows the required template with all sections completed: Summary, Why, Testing, Notes for Reviewer, and Pre-Review Checklist are all present and filled out.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch y3drk/feat/ensnodeio-new-lp-background

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@docs/ensnode.io/src/components/overrides/Hero.astro`:
- Around line 8-10: The section containing the background Image component is not
a positioned parent, so the Image with class "absolute w-full h-screen z-0 ..."
may be positioned relative to the page instead of the hero; update the section
element (the one that wraps the Image in Hero.astro) to include "relative" (and
preferably "overflow-hidden") in its class list so the Image's absolute
positioning is anchored to that hero container.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 5cb02403-05e3-4072-80d1-572b81d53173

📥 Commits

Reviewing files that changed from the base of the PR and between 2da6600 and 484267d.

⛔ Files ignored due to path filters (5)
  • docs/ensnode.io/public/OG_image.png is excluded by !**/*.png
  • docs/ensnode.io/public/Twitter_OG_image.png is excluded by !**/*.png
  • docs/ensnode.io/src/assets/hero_bg_image.png is excluded by !**/*.png
  • docs/ensnode.io/src/assets/hero_image.png is excluded by !**/*.png
  • docs/ensnode.io/src/assets/hero_skies_image.png is excluded by !**/*.png
📒 Files selected for processing (15)
  • docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts
  • docs/ensnode.io/src/components/molecules/HeaderButtons.tsx
  • docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx
  • docs/ensnode.io/src/components/organisms/OmnigraphAPIExample.astro
  • docs/ensnode.io/src/components/overrides/Hero.astro
  • docs/ensnode.io/src/content/docs/docs/integrate/index.mdx
  • docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enskit/example.mdx
  • docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enskit/index.mdx
  • docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enssdk/example.mdx
  • docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enssdk/index.mdx
  • docs/ensnode.io/src/layouts/Layout.astro
  • docs/ensnode.io/src/pages/index.astro
  • docs/ensnode.io/src/scripts/ScrollHeader.js
  • docs/ensnode.io/src/styles/onScrollHeader.css
  • docs/ensnode.io/src/styles/starlight.css

Comment thread docs/ensnode.io/src/components/overrides/Hero.astro Outdated
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR refines the ensnode.io docs site UI/UX (homepage hero/header behaviors + small docs presentation tweaks) to improve navigation polish and consistency across integration pages.

Changes:

  • Adjusts header scroll/hover styling (including mobile nav) via new onScrollContainer behavior and updated scroll class toggling.
  • Updates homepage hero visuals/layout and switches hero background asset usage.
  • Normalizes “Interactive example” titles/labels across MDX pages and the Starlight sidebar topic config.

Reviewed changes

Copilot reviewed 15 out of 20 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
docs/ensnode.io/src/styles/starlight.css Prevents non-top-level sidebar items from inheriting bold styling.
docs/ensnode.io/src/styles/onScrollHeader.css Adds hover background behavior for onScrollContainer in scrolled/unscrolled states.
docs/ensnode.io/src/scripts/ScrollHeader.js Toggles scrolled on elements with onScrollContainer for hover styling changes on scroll.
docs/ensnode.io/src/pages/index.astro Tweaks homepage section spacing/padding around JoinTelegram.
docs/ensnode.io/src/layouts/Layout.astro Updates the preloaded hero background image asset.
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enssdk/index.mdx Renames LinkCard title for the interactive example.
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enssdk/example.mdx Renames page title for interactive enssdk example.
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enskit/index.mdx Renames LinkCard title for the interactive example.
docs/ensnode.io/src/content/docs/docs/integrate/integration-options/enskit/example.mdx Renames page title for interactive enskit example.
docs/ensnode.io/src/content/docs/docs/integrate/index.mdx Renames LinkCard titles for interactive examples.
docs/ensnode.io/src/components/overrides/Hero.astro Redesigns hero layout and button styling; updates hero images.
docs/ensnode.io/src/components/organisms/OmnigraphAPIExample.astro Adds an icon to the “Back to Examples” link styling.
docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx Adds isScrollable prop and applies onScrollContainer class for scroll-aware hover styling.
docs/ensnode.io/src/components/molecules/HeaderButtons.tsx Applies onScrollContainer class to header links when scrollable; passes prop to mobile navigation.
docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts Updates sidebar labels for interactive examples to match new wording.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/ensnode.io/src/components/overrides/Hero.astro Outdated
Comment thread docs/ensnode.io/src/components/overrides/Hero.astro Outdated
Comment thread docs/ensnode.io/src/components/overrides/Hero.astro Outdated
@vercel vercel Bot temporarily deployed to Preview – ensrainbow.io May 20, 2026 12:56 Inactive
@vercel vercel Bot temporarily deployed to Preview – admin.ensnode.io May 20, 2026 12:56 Inactive
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 20, 2026

Greptile Summary

This PR delivers UI/UX refinements to the ENSNode landing page and documentation site, following updated Figma designs. The hero section is fully redesigned with a split layout (headline/CTA on the left, ENSv2 badge image on the right), a new background image, and improved responsive behaviour. The scroll-aware header gains theme-correct hover and focus-visible styles for buttons and the mobile hamburger on both transparent and scrolled backgrounds.

  • Landing page redesign: Replaces the full-bleed gradient sky with a dark background + hero_bg_image.png, adds a responsive two-column layout, and swaps the inline dark CTA button for legacyButtonVariants secondary style.
  • Scroll-aware header: Introduces onScrollContainer CSS class and supporting JS/CSS so header buttons and mobile nav correctly adapt colour on scroll, complementing the existing onScrollElement pattern.
  • Docs refinements: Repositions the ⚡ emoji to the end of interactive-example labels across sidebar config, MDX titles, and LinkCard headings; removes bold weight from nested sidebar items; improves the "Back to Examples" link with an icon and underline-offset hover animation.

Confidence Score: 5/5

Pure UI/UX changes with no logic affecting data, APIs, or build output — safe to merge.

All changes are confined to the presentation layer: Astro components, CSS, a small JS observer extension, MDX frontmatter titles, and image assets. The scroll-aware header refactor follows the existing onScrollElement pattern exactly, the hero redesign is self-contained, and the docs label changes are trivial text moves. No shared logic, no API surface, and the author confirmed typecheck, lint, and test passes locally and in CI.

No files require special attention.

Important Files Changed

Filename Overview
docs/ensnode.io/src/components/overrides/Hero.astro Full hero section redesign: new split layout, dark background with hero_bg_image.png, responsive badge image rendered twice (mobile/desktop) with CSS show/hide, CTA migrated to legacyButtonVariants.
docs/ensnode.io/src/components/molecules/HeaderButtons.tsx Buttons now conditionally apply onScrollContainer (CSS-managed hover/focus) vs hover:bg-black/5 depending on scroll context; passes isScrollable to mobile navigation.
docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx Adds isScrollable prop; hamburger button uses onScrollContainer class for theme-aware hover/focus when over the hero, and explicit hover:bg-black/5 focus-visible:outline-black otherwise.
docs/ensnode.io/src/styles/onScrollHeader.css New .onScrollContainer and .onScrollContainer.scrolled rules using modern CSS nesting to handle Tailwind v4 --color-white/--color-black variables for hover background and focus-visible outline colour.
docs/ensnode.io/src/scripts/ScrollHeader.js Extends the IntersectionObserver callback to toggle .scrolled on all .onScrollContainer elements, mirroring the existing behaviour for .onScrollElement.
docs/ensnode.io/src/components/organisms/OmnigraphAPIExample.astro Back to Examples link upgraded to an icon+text row with Starlight left-arrow icon, accent colour, and underline-offset hover animation.
docs/ensnode.io/src/styles/starlight.css Adds font-weight: normal to nested sidebar item labels so sub-items are not bold.
docs/ensnode.io/config/integrations/starlight/sidebar-topics/integrate.ts Emoji moved from leading to trailing position in both Interactive example sidebar labels.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[Page Load] --> B{On landing page?}
    B -- Yes --> C[isScrollable = true]
    B -- No --> D[isScrollable = false]

    C --> E[Header buttons & hamburger\nget class: onScrollContainer]
    D --> F[Header buttons & hamburger\nget class: hover:bg-black/5\nfocus-visible:outline-black]

    E --> G[ScrollHeader.js\nIntersectionObserver watches\nscrollWatcher div]
    G --> H{Hero section\nintersecting?}
    H -- Yes: at top --> I[No .scrolled class\nonScrollContainer hover = white/5\nfocus outline = white]
    H -- No: scrolled down --> J[.scrolled added\nonScrollContainer hover = black/5\nfocus outline = black]
Loading

Reviews (5): Last reviewed commit: "Apply ai assistant's suggestions, pt.3" | Re-trigger Greptile

Comment thread docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx
Comment thread docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx Outdated
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 15 out of 20 changed files in this pull request and generated 4 comments.

Comment thread docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx
Comment thread docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx Outdated
Comment thread docs/ensnode.io/src/components/overrides/Hero.astro Outdated
Comment thread docs/ensnode.io/src/components/organisms/OmnigraphAPIExample.astro Outdated
Comment thread docs/ensnode.io/src/components/overrides/Hero.astro Outdated
Comment thread docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx Outdated
Comment thread docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx Outdated
Comment thread docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx Outdated
Comment thread docs/ensnode.io/src/components/overrides/Hero.astro Outdated
Comment thread docs/ensnode.io/src/components/organisms/OmnigraphAPIExample.astro
Comment thread docs/ensnode.io/src/components/organisms/OmnigraphAPIExample.astro Outdated
Comment thread docs/ensnode.io/src/components/molecules/HeaderMobileNavigation.tsx Outdated
@Y3drk
Copy link
Copy Markdown
Member Author

Y3drk commented May 20, 2026

@greptileai

Comment thread docs/ensnode.io/src/components/organisms/OmnigraphAPIExample.astro Outdated
Copilot AI review requested due to automatic review settings May 20, 2026 13:35
@vercel vercel Bot temporarily deployed to Preview – ensrainbow.io May 20, 2026 13:35 Inactive
@vercel vercel Bot temporarily deployed to Preview – admin.ensnode.io May 20, 2026 13:35 Inactive
@Y3drk
Copy link
Copy Markdown
Member Author

Y3drk commented May 20, 2026

@greptileai

<a href="/docs/integrate/omnigraph/examples">Back to Examples</a>
</p>
<a class="group w-fit flex flex-row justify-start items-center gap-2" href="/docs/integrate/omnigraph/examples">
<Icon name="left-arrow" class="h-5 w-5 text-[var(--sl-color-accent)] group-hover:text-[var(--sl-color-white)] transition-colors duration-200" />
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Icon hover invisible in Starlight light mode

--sl-color-white is hardcoded to #ffffff in Starlight regardless of the active theme. In light mode the docs page background is near-white, so the icon becomes invisible on hover (white icon on a white/light surface). The default state — text-[var(--sl-color-accent)] — is theme-aware and visible in both modes; a consistent hover could use group-hover:text-[var(--sl-color-accent-high)] or group-hover:opacity-80 instead of switching to white.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's not true. The hover is not set up correctly (see the attached screenshot), and the variable is set to a dark (near-black) color, not white.

image

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 15 out of 20 changed files in this pull request and generated 3 comments.

Comment thread docs/ensnode.io/src/styles/onScrollHeader.css
Comment thread docs/ensnode.io/src/scripts/ScrollHeader.js
Comment thread docs/ensnode.io/src/components/organisms/OmnigraphAPIExample.astro
@Y3drk Y3drk linked an issue May 20, 2026 that may be closed by this pull request
Comment thread docs/ensnode.io/src/components/organisms/OmnigraphAPIExample.astro
Comment thread docs/ensnode.io/src/styles/onScrollHeader.css
Comment thread docs/ensnode.io/src/styles/onScrollHeader.css
Copy link
Copy Markdown
Member

@lightwalker-eth lightwalker-eth left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Y3drk Great to see these updates. Thank you! 👍

@lightwalker-eth lightwalker-eth merged commit 9f4bb10 into main May 20, 2026
21 checks passed
@lightwalker-eth lightwalker-eth deleted the y3drk/feat/ensnodeio-new-lp-background branch May 20, 2026 16:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Docs related

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Refine ENSNode Docs Site UX

3 participants